Collection of Tools & Utilities

home *** CD-ROM | disk | FTP | other *** search

/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / pro_bat.zip / PROBAT.MAN < prev next >

Wrap

Text File | 1990-03-01 | 68KB | 1,646 lines

*BoldFace on P R O - B A T version I Professional Batch File Development Environment (C)Copyright September 11, 1988 Mark Tigges All rights reserved. _______ ____|__ | (tm) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER *BoldFace off *FormFeed 1. COPYRIGHT This program is copyright (C) 1989 by Mark Tigges. All rights reserved. Non-registered users are granted a limited license to use this product on a trial basis, and to copy the program for trial use by others subject to the following limitations: The program is distributed in unmodified form, complete with documentation. No fee, charge or other consideration is requested or accepted upon said distribution. The program is not distributed in conjunction with any other product. Once the trial period of 3 weeks has expired you register your copy of Probat, if you wish to continue use. If you intend to use ProBat on a regular basis, registration is expected, please show your support for the author. Commercial, business or governmental use by non-registered users is prohibited. *FormFeed 1. Table of Contents 1 Copyright Statement 1 2 Table of Contents 2 3 Introduction 3 3.1 Features 5 4 The Pull-Down Menu 5 4.1 Usage 5 4.2 Features 6 4.3 The File Menu 6 4.4 The Screens Menu 9 4.5 The Edit Menu 10 4.6 The Menu Menu 12 4.7 The Options Menu 14 5 The ProBat Editor 17 5.1 Commands 17 5.1.1 Editing Commands 17 5.1.2 Find & Replace Commands 19 5.1.3 Block Commands 19 5.1.4 Miscellaneous Commands 20 5.2 Editor Help 21 6 The Prompt Editor 22 7 The Screen Generator 23 7.1 The Screen Generator Menu 23 8 The Supplementary Programs 26 8.1 PBShow.EXE 26 8.2 PBMenu.EXE 26 9 ProBat Help 28 10 Running ProBat 29 10.1 On a Hard Disk 29 10.2 On a Floppy Disk 30 11 The Distribution Diskettes 32 11.1 PrintMan.EXE . . . Usage 32 12 About Ansi.SYS 33 13 Registering your copy 34 *FormFeed *BoldFace on *Wide 3. Introduction *BoldFace off Probat is program that runs on IBM computers running MS-DOS. It supplies the user an environment that is designed for producing batch files. The batch files that ProBat can help you develop are much more powerful in nature then batch files you might otherwise create. This power allows you to tailor the MS-DOS environment to a greater degree, making computing on your machine easier and more enjoyable. 3.1 Features - Easy to use pull-down menu system. - Full fledged command driven editor designed for writing batch files, that features quick easy interaction with the menu. - Distinguishes files in full pathnames when user is prompted for a file. - Complete screen generator capable of creating files of screens that use reverse video, variable intensity, caps lock, box drawing and variable line types. These screens can then be recalled within a batch file by using a separate program called PBSHOW. - User customizable menu program called PBMENU which displays your data using handsome graphics. Use this program on its own or from ProBat, whichever way it allows you ease of command over your hard disk. - A printing program built within ProBat that highlights your labels in your batch file, thus making reviews of your printed hardcopies easier, facilitating a quicker de-bugging process. - A menu for controlling DOS functions on the .SCR files with an operating shell function. A menu for managing your .SCR files, and accessing the screen generator. A file for managing you batch files and accessing the editor. And a menu for controlling the customizable menu program PBMENU. - A very extensive Help system, can be used from a main help menu, or touch sensitive from within the menu. When you start Pro-Bat the main menu selections appear on the top line and the program identifies itself, showing the version number and copyright message. It also displays the registration number and name of the owner of the copy, you should send in that information if you wish to register the copy in your own name. A new copy will be sent to you that displays your name and registration number instead. NOTE - There are a lot of traps in this program that need to be understood if your work with ProBat will be enjoyable and stay disaster free. If you read this manual thoroughly you shouldn't be confronted with too much of a problem and ProBat will run smoothly and enjoyably. *FormFeed *BoldFace on *Wide 4. The Pull-Down Menu 4.1 Usage *BoldFace off Use of the pull-down menu system is easy. Across the top of the screen is displayed the five options of the main menu, these are descriptive headings for the options. By moving the highlight bar which will at first be positioned at the first option "File" you can select the other four options. These are: "Screen", "Edit", "Menu" and "Quit". This is done by pushing the right or left arrow key, the highlight bar moves in the corresponding direction. Under all of the options except "Quit" there is another menu, these four vertical menus are the secondary menses. They each have a highlight bar of their own which moves according to the corresponding horizontal arrow button you push. To select an option you simply press RETURN. ProBat's ensuing reaction is dependent on where the secondary menues highlight bar is position. For instance if you are in the "Edit" menu and the highlight bar is on "Start a new file" and you select that ( hit RETURN ) then ProBat will display a pop-up box prompting for the name of the batch file you want to start. If you have the main menues highlight bar on "Quit" and you hit return then the program stops running and you return to DOS. You can play around with this for a while if you want; if you get somewhere you don't want to be push ESC, it will return you to where you were. The PullDown menu supports quick selection, that is by pressing a letter key ProBat will automatically open the function in the present menu that corresponds to the letter you just pushed. Example: In the "Menu" menu there are the following options: Enter data for menu Run personalized menu Check menu batch file Print menu data In ProBat this appears with the first letter of each option highlighted. If you pushed "C" or "c" regardless of where the selection bar was in the "Menu" menu ProBat would select the "Check menu batch file" option and begin the corresponding process. *BoldFace on 4.2 Features *BoldFace off - Full movement of command by usage of the arrow keys. - Home and End pushing these keys depending on a few factors will get you to either the "Options" menu (End) of main menu or "File" (Home) function of main menu or Home will get you to the first option of current secondary menu and End will get you to the last. - F1 gets you help on using ProBat. CTRL-F1 gets you help on the current secondary menu. ALT-F1 gets you help on the selected topic. - F10 shows you statistics and settings you have employed. - Pushing the key 'V' will show you the version of ProBat you are using. - Pushing 'CTRL-S' will put the program in suspension so that you can leave the computer for a long period of time without having to worry about screen burn. - Pushing 'CTRL-R' will show you the registration number and owner of the copy. - Hitting ESC will almost always get you out of mistaken selection. Or if you are not in one into the editor editing the file that is loaded. - Pushing ALT-Q anywhere including in the editor except for a menu option has been selected, will quit the program. *BoldFace on 4.3 The File Menu *BoldFace off This menu enables you to take care of menial DOS functions from within the program and without using the Os Shell function. These are "Dir" and "ChDir" however for anything else there is the Os-Shell option. Whenever you are asked for the name of a file when you are in this, or any other menu for instance you can use full path names for the file, eg. C:\BATCH\MYSCRNS.SCR, ProBat will go to the directory C:\BATCH before trying to load the file MYSCRNS.SCR. With the screen files ProBat reserves no convention for the file extensions, it does not care what you call the file. Therefore if you load "DBASE.EXE" if you own it and you try and save a screen on top of the program then you are out a $300 program so watch out, don't do anything dumb. It is a wise thing to call all of your screen files "????????.SCR" that way you know what your looking at. *BoldFace on Load *BoldFace off This option simply loads a file for use with the screen functions. With this function the file must have previously existed, if you want to create a new file to use for storing screens use the New File option. After selection a pop-up prompt box appears asking for the name of the file. *BoldFace on Pick *BoldFace off This option is a very handy utility. Every time you load a ".SCR" file ProBat remembers it and puts it in a list. Then when you use the Pick function it shows you that list in menu form and you pick the file that you want to re-load. *BoldFace on New file *BoldFace off This option is used when you want to start a file for storing screens. A prompt box appears asking for the name of the new file and then if ProBat does not find conflict it creates that file. If ProBat does find a conflict (another file by the same name on the same directory) then it asks you if you want to continue. When ProBat asks you if you want to continue it really means "Do you want to sacrifice whatever is in that already existing file for this one you want? Because if you say yes the original will be deleted, and replaced with this one." So keep that in mind. Used improperly this option could make you a very frustrated person. *BoldFace on Write to *BoldFace off This option allows you to save the current screen file in use to another file with a different name. This lets you make copy of some screens which you use often, even create a file that lets you archive all of the screens that you have ever used, or screens that you use frequently. *BoldFace on Directory *BoldFace off Selecting this option will let you view the contents of the current directory in a pop-up window. You will be first asked to enter a file mask, so that you can view more specifically those files that you wish to see. If the number of files in the directory are greater than can be shown at once in the window then you will be abe to scroll through the files using PgUp and PgDn. The function is able to display four screens of files in total. If more files than that exist (400+) in the directory then they simply will be left out. There shouldn't be too many occasions when the number of files on a directory exceeds ProBat's limits. *BoldFace on Change dir *BoldFace off This option prompts you with a pop-up box for a path name to switch the current DOS directory to. If an error occurs then ProBat alerts you to that fact and lets you enter again. *BoldFace on Os shell *BoldFace off This option prompts you with a pop-up box for a DOS command. You can use any valid DOS command that you ordinarily would use and MS-DOS will perform that command. If however you have more than one command to give to DOS you need only hit return without entering anything and ProBat will put you in DOS for as long as you want. When you want to come back to ProBat just type EXIT and the DOS prompt and ProBat will resume where you left off. *BoldFace on Quit *BoldFace off This option closes your session down. It can also be accessed by pressing ALT-Q anywhere in Pro-Bat. If you have opted to generate Pick files then they are created now. *BoldFace on 4.4 The Screens Menu *BoldFace off This menu lets you manage all of your screen files. Doing the tasks to them that need to be done. Such as adding screens editing screens deleting screen and copying screens between files. If you have not loaded a screen file then ProBat will ask you what file you want to use. You can use full path names to specify files. *BoldFace on Add a screen to the file *BoldFace off This functions is the gateway to the screen generator. When you use this function ProBat clears the screen and lets you and your artistic sense loose to create your screen, when you are finished creating your masterpiece then ProBat adds that screen to the file when you push F9, to get out of the generator push F10. For more info go into the screen generator and hit F1 and you will be shown all the commands for high and low intensity and reverse video, capital letters and box drawing characters. Or you can refer to this manual in the Screen Generator section for more detail. *BoldFace on Edit an existing screen *BoldFace off You must use this function when you want to change a screen that you have already designed in the file. ProBat will ask for the number of the screen and then let you edit it if it exists. When you are finished press F9 and ProBat saves the screen in the same position that it got it from. *BoldFace on Delete a screen in the file *BoldFace off When you have a screen that you no longer want then use this function. However all that ProBat does is blank the slot. You now have a file that has a hole. You can now re-edit that screen. When you call it up there will be a blank screen. *BoldFace on View all screens in the file *BoldFace off This option shows you all of the screens in the file in use. When you call it up it starts on the first screen and then waits for you to press a key - telling ProBat that you want to see the next screen. *BoldFace on Copy a screen between files *BoldFace off If you have one screen in a file that you want in another file as well then use this option. Use is pretty straightforward - ProBat prompts for the source file, the destination file and then the source files screen number and then it does the job. If it can't find the source file, the destination file or the screen in the source file then it doesn't work. So there is a lot of stuff here that can go wrong, watch out! *BoldFace on 4.5 The Edit Menu *BoldFace off This menu is the menu that lets you do the heart of what batch files need. They need to be edited and this menu is the editor. When you are prompted for the name of a file you may enter full pathnames. When you save that file again it will be saved in its original directory. Upon loading a file if you don't specify a file extension then ProBat will assume you mean ".Bat" and will add it to your file name. Please see the section of this manual for detailed help on using the editor. *BoldFace on Load a batch file for editing *BoldFace off The title of this function is a bit deceiving because what you load need not be a batch file. In fact you can load any kind of text file that you want however the editor is best suited for writing Batch files or computer programs or the like. Since it doesn't have the option of word wrap and adjustable margins. After selection of this option ProBat will respond by displaying a pop-up prompt box asking for the name of the file that you wish to edit. If ProBat can't find the file in the specified directory it will tell you so. It won't load an empty file from this option. You must use the Start a new batch file option from the same menu. To edit a file that as yet does not exist. *BoldFace on Pick batch file for editing *BoldFace off This option is very similar in purpose to the Pick option of the file menu. ProBat remembers all of the recently loaded batch files, and will, when this option is chosen, display them in a menu, enabling you to pick easily from this menu the file you want to edit. After selecting this option a pop-up box appears, sized depending on the files in the menu, displaying the files that you have recently loaded. There will also be a highlight bar which you use to pick the file you want. Position the highlight bar on the chosen file and hit Return. That file will then be loaded into the editor and you will be place at the top of that file ready to edit. If you hit return on the selection that is identical to the file in the editor, then ProBat will drop you in the file in exactly the same place that you left it allowing you to continue editing. *BoldFace on Begin a new batch file *BoldFace off Again the file to start need not be a batch file it can be any file, however if you don't specify an extension ProBat will assume .BAT. This option differs from the above only that it cannot load a file that already has text in it. Therefore if at the prompt you specify a file that already exists ProBat will question your intention. If you confirm your entry ProBat will ERASE THE ORIGINAL and give you a blank file where the first text can be entered. So for God's sake be careful! I hate it when my program is an outlet for inexperienced user's frustration, especially one that didn't read the manual correctly. If you do use this option to try and load a file that already exists, and answer YES to ProBat's question, that you do want to continue, then your file will be erased. *BoldFace on Delete a batch file *BoldFace off Once again the file need not be a batch file however if you don't specify an extension then ProBat adds .BAT by default. This option does not confirm your entry from its pop-up prompt box before it deletes the file. If for instance you accidentally give the wrong path or you enter .BAT instead of .BAK you will be very sorry. So before pushing the ENTER key make sure that you have entered the right file. If ProBat can't find the file then it obviously can't delete it so it will let you know if you make a mistake. *BoldFace on Run a batch file *BoldFace off The restraints on the type of file that this option requires are a little more stringent than the others in the menu. The type of file that you specify in the pop-up prompt box must be an executable file ie. ?.EXE, ?.BAT, or ?.COM. If ProBat can't find the file then it will let you know, because it can't run it if it can't find it. *BoldFace on Print a batch file *BoldFace off This option will print all of your batch files for you. If it finds a label in your batch file then it will highlight it with bold print, making them stand out from all of the other text on the page. It will stop for page breaks, and give the page number and file name at the bottom of each page, and will also automatically insert a margin of five spaces at the beginning of each line. If your printer supports compressed mode and you select it to print your batch files then ProBat will not be able to bold type your labels. *BoldFace on Save file in editor *BoldFace off This option lets you save the loaded text file to the current drive and directory. If you don't want to enter the editor, but you do want to save the file then this is a very handy option to use. It will tell you wether or not you should bother saving. If the file has been modified since the last save then the option will be displayed like this: *BoldFace on Save file in editor SAVE *BoldFace off When you see the SAVE flag you know you should save the file, if there is no SAVE flag there then the file has not been modified. If you select the option without the flag there Pro-Bat will ignore you assume incompetence and not do anything. *BoldFace on 4.6 The Menu Menu *BoldFace off This menu takes care of all of the chores that need to be done concerning the custom menu system. Such as the editing of your menu - the keys and items. And making sure that your CustMenu.Bat file will work correctly. You can even run the program to check it from within Pro-Bat. *BoldFace on Edit menu data *BoldFace off This option is the one you use to create the PBMenu.DTA file. That file contains the names of your items and whatever you want to use for your keys. I suggest using succesive numbers. Instead of letters in some configuration because the third option of this menu won't work properly otherwise, and it is very useful. You are shown a table of empty spaces after you select this option. The empty spaces are what you fill in, to define your menu. The title refers to the name of the menu. When you have finished editing push ESC to save the data. If you edit one space and then push ESC to save without first pushing RETURN then that one space won't be saved because it wasn't first entered into menu. *BoldFace on Run custom menu *BoldFace off This option simply runs the PBMenu.exe file. The exact thing as type PBMenu at the DOS prompt. If the files that the program needs aren't on the current dos directory then the program won't run you have to make sure that these files are all located on the current directory everytime the menu runs. That includes after you have selected a item and the menu is running again. *BoldFace on Check batch file *BoldFace off This option only checks the Batch file custmenu.bat. Therefore it needs to read the data in PBMenu.dta first, therefore both of these files have to be located on the current directory for this option to work. What it does is look at all of your labels to see if there are the right number of numeric labels. ( If you are unfamiliar with labels please refer to your Dos manuals. Books such as Running Ms Dos by Van Wolverton are also very helpful.) Therefore if you don't use numeric labels then this option won't work. It is your choice and the burden is yours to check you CustMenu.bat file if you use a different method. *BoldFace on Print menu data *BoldFace off For convenient reference this option will print for you the data that is in your menu. This is so that you have something to refer to when you are creating your CUSTMENU.BAT file. *BoldFace on Menu text height *BoldFace off This option allows the user the affordability of changing the relative height of the text displayed in the menu. For graphic formats reasons the height of the text is interpreted differently by different systems. The higher resolution of some systems displays the Fonts larger then a smaller resolution. For this reason I have included this option. I wrote the code on a hercules monochrome card and a height value of 2 is optimum therefore it is the default. On a CGA or AT&T it is a different value. Experiment and come up with the value that you like the best. *BoldFace on 4.7 The Options menu *BoldFace off This menu lets you customize Pro-Bat to your tastes. Creating an environment that lets you work to an optimum level. You have the choice of turning on/off the sounds, editor window, mode pick file saves, and changing the colors. *BoldFace on Editor window mode *BoldFace off This option is a toggle on/off option, its value is displayed as ON or OFF at the right of the selection bar. If the mode is ON then the editor is displayed inside a thin frame, the full pathname of the file being edited is displayed at the lower left corner of the window. If the option is OFF then there is no frame around the editor and the user gets the full amount of room possible to edit the file. There is not a large sacrifice of room when the editor window is on. *BoldFace on Auto-backup *BoldFace off This option is a toggle on/off option, its value is displayed as ON or OFF at the right of the selection bar. If the mode is ON the editor will create a backup copy of the file when ever it is saved, naming that copy with the extension .BAK. If the mode is OFF this service is not done. it is highly recomended that you leave this mode on. *BoldFace on Generate pick file *BoldFace off This option is a toggle on/off option, its value is displayed as ON or OFF at the right of the selection bar. If the mode is on then when you quit the current run of ProBat a file named PROBAT.PCK is saved. It is a list of all the files that were on the pick sequences. If the mode is off then ProBat will not save this file. ProBat will read a PROBAT.PCK file and use it regardless of the value of this option. *BoldFace on Warning sound *BoldFace off This option is a toggle on/off option, its value is displayed as ON or OFF at the right of the selection bar. Whenever you make a mistake for instance naming a false directory or filename, ProBat will make an obnoxious noise to alert your attention to your mistake. If you do not like this noise, or you have a hangover you can turn it off, in effect silencing ProBat. *BoldFace on Colors *BoldFace off This option will let you create the visual effect that you enjoy the best. After selecting the option a menu and another box is displayed. When you choose an option from the main menu, a sample of the choice is displayed in the other box. For instance say you chose : *BoldFace on Main menu normal text *BoldFace off a portion of the main menu would be displayed, you then have the power to change the color in which this item is displayed. Change the foreground color by pushing 'f', the background by pushing 'b'. If you use the upper case versions of these letters then the numeric values corresponding to the colors will decrease, as oppose to increase with the lower case. When you use Pro-Bat from there on the colors will be displayed as to your choice. The method of manipulating the colors is simple. In the CGA color spectrum (the one that ProBat assumes) there are 15 colors. As the numeric value corresponding to the item you've selected change ProBat selects the numbered color value in the CGA spectrum. This applies both for ForeGround and BackGround aspects. *BoldFace on Save set-up *BoldFace off This option lets you save the environment configuration that you have created to a file called PROBAT.DTA. When you start Pro-Bat with a file by this name on the current directory then Pro-Bat will read this file and use the settings in it instead of the default set. This makes for convience, you don't have to change the environment to your needs every time you use the program. If you have several users of the same copy, they might not all like the same configuration. These people could all have a floppy of their own containing there version of PROBAT.DTA on it. Then these people each load probat like this : *BoldFace on A:\>c:\bat\probat *BoldFace off this way Pro-Bat will look on A:\ for the PROBAT.DTA file. Remember that when you change the configuration Pro-Bat doesn't automatically save it. You might be mad next time you run Pro-Bat if your configuration doesn't appear. So save it. *FormFeed *BoldFace on *Wide 5. The Pro-Bat Editor *BoldFace off To start the editor refer to the various functions under the Edit menu section. To enter text into the editor you use basically the same technique that you employ in using a type writer. There are however many important differences. The cursor always indicates where the new text will be entered, and you can move the cursor in a number of ways (the commands to do so are described later). You can correct mistakes quickly and easily using the delete commands. You can copy and move text with the block commands. You can locate a particular string of text with the find command, and optionally replace it with another string using the Find-Replace command. And in most cases, you can even undo your last few changes with the restore line or undo commands. Each of these commands ( and there are many more ) is described in the sections that follow. However for a quick glance at all the commands and their respective keystrokes, refer to, the quick-reference tables available in the editor's help section - hit F1 to obtain help in the editor. *BoldFace on 5.1 Editor Commands *BoldFace off NOTE - When you see CTRL-? it means that the CTRL key is held down while ? is pressed. *BoldFace on 5.1.1 Basic Editing Commands *BoldFace off LEFT ARROW or CTRL-S - CHARACTER LEFT. Moves the cursor left one column. This command does not work across line breaks; when the cursor reaches column 1, it stops. RIGHT ARROW or CTRL-D - CHARACTER RIGHT. Moves the cursor one character to the right. This command does not work across line breaks; when the cursor reaches the right-hand edge of the text window, the text starts scrolling horizontal until it reaches the extreme right edge of the line ( column 999 ), where it stops. CTRL-LEFT ARROW or CTRL-A - WORD LEFT. Moves the cursor to the beginning of the word to the left. This command works across line breaks. CTRL-RIGHT ARROW or CTRL-F - WORD RIGHT. Move the cursor to the beginning of the word to the right. This command works across line breaks. UP ARROW or CTRL-E - LINE UP. Moves the cursor to the line above. If the cursor is on the line of the window, the window scrolls down one line (if there is more text to scroll). DOWN ARROW or CTRL-X - LINE DOWN. Moves the cursor to the line below. If the cursor is on the last line of the window, the window scrolls down one line (if there is more text to scroll). PGUP or CTRL-R - PAGE UP. Moves the cursor one page up with an overlap of one line. PGDN or CTRL-C - PAGE DOWN. Moves the cursor one page down with an overlap of one line. CTRL-K 0..3 - SET MARKER. Sets one of the ten text markers at the current position of the cursor. CTRL-K 0 sets marker 0 and CTRL-K 1 sets marker 1 . . . CTRL-Q 0..3 - GOTO MARKER. Goes to the specified marker. If the specified marker has not been set the cursor does not move. CTRL-Q-P - PREVIOUS CURSOR POSITION. Moves the cursor to its previous position. This works after a Find or a Find/Replace function has been carried out. DEL or CTRL-G - DELETE CURRENT CHARACTER. Deletes the character which contains the cursor the cursor does not move. BACKSPACE or CTRL-H - DELETE CHARACTER TO THE LEFT. Deletes the character to the left of the cursor and moves the cursor right. CTRL-Y - DELETE LINE. Deletes the entire line that contains the cursor. CTRL-Q-Y - DELETE TO THE END OF LINE. Deletes from the character position to the end of the line. CTRL-T - DELETE WORD. Deletes the text up to the beginning of the word to the right of the cursor. TAB - INDENT. Indents the cursor to the first character of the previous line that is past the position of the cursor. *BoldFace on 5.1.2 Find & Replace Commands *BoldFace off B - Searches backwards from the current cursor position toward the beginning of the file. G - Searches globally. The entire file is scanned for the search string regardless of the current cursor position. L - Searches only the marked block. U - Ignores case configuration. W - Searches for whole words only, skips out matching patterns embedded in other words. n - n may be any number. Find the nth occurence of the search string counted from the current cursor position. CTRL-Q-F - FIND. Lets you search for string of up to 67 characters. When you call this command you will be asked for a search string and then options; you can include any of the above options in any combinations. CTRL-Q-A - FIND/REPLACE. Lets you search for a string the same way as above however it replaces that string with a specified replace string. There is one more option that is available for searching : N this lets you skip confirmation to replace every match. CTRL-L - REPEAT LAST SEARCH. This command will do the last search that you did again allowing you to quickly find the next occurence of the search string without reentering the specs. *BoldFace on 5.1.3 Block Commands *BoldFace off F7 or CTRL-K-B - BEGIN BLOCK. Marks the beginning of a block. The block is not visible unless an end of block marker has been set. The block is shown in highlighted text. F8 or CTRL-K-K - END BLOCK. Marks the end of a block. Like the begin-block command the block does not become visible unless a start of block marker has been set. CTRL-K-C - COPY BLOCK. Creates a copy of a marked and displayed block at the current cursor position. The original block is left unchanged, and the markers are placed around the new copy of the block. CTRL-K-V - MOVE BLOCK. Moves a marked and displayed block from its current position to the cursor's position. The markers remain around the block at its new position. CTRL-K-Y - DELETE BLOCK. Delete a marked and displayed block. Although the Undo last deletion command ( ctrl-Q-U ) can usually restore portions of an accidentally deleted block, there is no command to restore a deleted block in its entirety so use this command with care. CTRL-K-H - HIDE BLOCK. Toggles off and on the visual marking of a block. CTRL-K-T - MARK WORD. Marks word contained by the cursor as a block. CTRL-K-R - READ BLOCK FROM FILE. Reads a file into the text at the cursor's current position exactly as if it were copied from another part of the text. You are prompted for the path and name of the file. CTRL-K-W - WRITE BLOCK TO FILE. Writes the currently marked block to a file. You are first prompted for a file name, and then ProBat writes the block to disk under that name with no change to its text. *BoldFace on 5.1.4 Miscellaneous Commands *BoldFace off CTRL-U - ABORT. Halts whatever command is already in progress. CTRL-K-S - SAVE AND EDIT. Simply save the current file and continue editing. CTRL-Q-L - RESTORE LINE. Will undo any changes done to the current line since you entered that line. It does not work after you left that line anymore. CTRL-Q-U - UNDO DELETION. Restores whole lines deleted with the delete line command (CTRL-Y) or the Delete block command ( ctrl-K-Y ). It does not restore single characters or words. INS or CTRL-V - TOGGLE INSERT MODE. Selects Insert or Overwrite mode. The cursor's size is an indication of which mode you are in. CTRL-Q-I - TOGGLE AUTOINDENT. When autoindent mode is in effect, the new line command ( ENTER ) will return the cursor to the first character of the previous line. F10 - EXIT EDITOR. This command will return you to the main menu. However it does not save the file, so you must keep that in mind. *BoldFace on 5.2 Editor Help *BoldFace off The editor's help system isn't very extensive. All that is included are tables of commands. When you push F1 you are faced with a message and a menu from which you can select a group of commands to choose to get further help. *FormFeed *BoldFace on *Wide 6. The Prompt Editor *BoldFace off The line editor which is used for all of the prompts has itself many commands to alter and edit text. If you are presented with a response already you can enter that response by hitting <return>. Home : This moves the cursor to the beginning of your line. End : This moves the cursor to the end of your line. Insert : This will toggle the insert specification. If you have it on then hitting the insert key will call overwrite and vice versa. Del : This key will delete the Digit that the cursor is centered on. BackSpace : This key moves the cursor backwards one space at a time while deleting every character in its path. ALT-B : This key will automatically enter the path name of the file in the editor to the prompt editor. ALT-S : This key will automatically enter the path name of the screen file that is in current use. Horizontal arrow keys : These keys will move, in their respective direction, the cursor one space. Vertical arrow keys : These keys are treated as the equivalent of <RETURN>. *FormFeed *BoldFace on *Wide 7. The Screen Generator *BoldFace off The screen generator is a low level word processor that allows you to type anything on the screen in any video attribute, including boxes with either of the two IBM line modes (single and double). The generator does not have any idea what you are typing in. After you have typed the key the screen generator forgets what it was. Therefore if you go to the same place again the generator won't know what is there so it ignores it. If you type a character on top of another character the original character will be lost. Arrow keys are not included as characters, if you hit an arrow key when there is another character at the cursor the original character will still be there. If you are editing a screen by having used the Edit existing screen or the Add a new screen option and are finished doing so, you will want to save it. Pushing F10 does not save the screen before giving you back ProBat, you must first use F9 or your screen will be lost. Be careful, after much thought I concluded that this was the best way because this way you can edit - save and continue editing without leaving the generator or the screen. In short save before you are finished or mid way in your editing job in case an accident occurs. The theory upon how the screen generator is integrated into the rest of Pro-Bat is this. You work on screens in a file environment, each screen being a separate record withen a file that stores your screens. You can change a screen at your whim after you have created and saved it once, just like a word processor. However the first screen in the file is a special screen. It is numbered 0 and is called the template. Presumably when you store screens in a file those screens must somehow be related. For instance in the file EXAMPLE.SCR all of those screens are for display in the sample menu system. We can assume that on some circumstances the screens in the file may look very familiar to each other. This is where the template comes in. To work on a series of screens, all you have to do is load the template before you start work on each screen. Then doing whatever is unique about each particular screen. *BoldFace on 7.1 The Screen Generator Menu *BoldFace off The screen generator has several functions that can be accessed via a menu. This menu is called up by pressing F10 when you are in the screen generator. Those functions are listed below. *BoldFace on Change foreground color *BoldFace off Choosing this option calls up a menu of the 16 different colors possible in a CGA system, choosing one of those colors changes the color with which the foreground of subsequent text is displayed. *BoldFace on Change background color *BoldFace off This option is identical to the above only that you choose the background color. *BoldFace on Display color table *BoldFace off This option will merely bring up a reference table of the numerical values of the colors in the CGA spectrum. *BoldFace on Load the template *BoldFace off This option loads screen no 0 into the present screen and allows you to edit it. The editing you do does nothing to change the template screen. if you have worked on a screen and then load the template the work you have done previously will be lost. *BoldFace on Save this screen *BoldFace off This option will save the screen you are working on in the correct position in the file. *BoldFace on Abandon this screen *BoldFace off This will merely give you a clear slate by clearing the screen. If you saved your previous work however then that work still exists on the disk. *BoldFace on Toggle box mode *BoldFace off When on box mode allows you to display boxes. Selecting this mode changes the value of box mode. If it was on it will be turned off and vice versa. To display a box use the following keys when in box mode: w rrrrr e ie. W : Top left corner f f R : Horizontal line f f E : Top right corner s rrrrr d F : Vertical line D : Bottom right corner S : Bottom left corner *BoldFace on Toggle box style *BoldFace off This changes the line mode between single and double regardless of the value of the Box drawing mode. *BoldFace on Display statistics *BoldFace off Selecting this option will display a window containing the following information: -Filename -Screen no. -Value of Box drawing mode -Type of Box style enabled -Foreground color -Background color -X position -Y position *BoldFace on Quit screen generator *BoldFace off This function will allow you to exit the screen generator back to the point where you left ProBat. It will not check to see if you have saved your screen, so if you need to make sure you do. *FormFeed *BoldFace on *Wide 8. The Supplementary Programs *BoldFace off On the distribution disk there are two PB????.EXE files. These two files are not cardinal to ProBat's running however if you want to take full advantage of ProBat's capabilities then you will be using these programs. There are two of them: PBSHOW.EXE and PBMENU.EXE. Each has their own use and each depend on ProBat to produce the things they need to run however once they have them they run totally on their own. 8.1 PBSHOW.EXE This file is used in conjunction with the .SCR files it is your ticket to displaying the screens you have created in ProBat from within a batch file. Usage : PBSHOW %1 %2 where %1 & %2 are parameters you pass to the program. %1 - The number of screen in the file you want displayed. The first screen is #0, the second screen is #1 etc. %2 - The file that the screen is located in. ie MYSCRNS.SCR. Therefore typing PBSHOW 0 MYSCRNS.SCR will display the first screen in the file MYSCRNS.SCR. 8.2 PBMENU.EXE This file is used to display your customized menu. If you haven't defined one using the Enter menu data option of the Menu menu then it won't work, otherwise it will display the Keys and Items that you defined. Usage : PBMENU. All you have to type is the files name. From there the program will display your menu ( in a very good-looking graphic format ). PBMENU will take your reponse and pass it to your CUSTMENU.BAT file as a parameter. CustMenu.bat : This file is a batch file that does what your menu says it will do. For example lets say that the user of your menu selects the first option of your menu. That response will be passed to this file as a parameter. Lets say the first option of your menu was *BoldFace on 1. Run Word Processor *BoldFace off The user would have typed 1 [RETURN] therefore CustMenu would be given '1' as its parameter. If you have a label in CUSTMENU.BAT called 1 then you can differentiate the input with labels. If you are unfamiliar with labels and batch file structure please refer to you MS-DOS manual, it should be explained there. Books such as Running Ms-Dos by Van Wolverton are also very helpful! So the CustMenu file might look like this echo off cls goto %1 :1 cd\EDIT Word REM or whatever wordprocessor you own goto DONE REM the above line is very important. It must REM be the last line in each Label or DOS will REM run each label that appears after the one REM you wanted before returning you to the REM menu. REM one label for each key of your menu would REM exist here. :DONE CD\BATCH REM Or whatever directory you hold the PBMENU REM program in. This line is very important REM because otherwise PBMENU won't be able to REM find CUSTMENU.BAT to run your next choice. *FormFeed *BoldFace on *Wide 9. The Pro-Bat Help System *BoldFace off The ProBat help system is a very extensive one. If you can see it in the main menu then you can get help on it. It is easy to use and very comprehensible. By hitting the key F1 you have a resource of information which is much more concise though certainly comparable to this manual's. By working your way through the help system using the menus you can eventually find what you want. However this is slow and becomes too repetitive if you want to look at twice very quickly. To solve this problem there are two other ways to access the information: ALT-F1 and CTRL-F1. ALT-F1. Pressing this combination of keys gives you very specific information. It will tell you all about the part of Pro-Bat that the highlighted selection bar is positioned on. For instance say you are in the Screens menu and the highlight bar is on Delete a screen from file and you press ALT-F1. Strange and wonderful things happen. You get information on what Deleting a screen from file is all about. With this method of Help access the beginner can quickly get the gist of how to use the program. And more or less what the program can do for you. CTRL-F1. To complement ALT-F1 there is this capability. If this sequence of keys is pressed then you will get help on whichever menu is currently open. Say that you are in the Edit menu. You press CTRL-F1 and you get a message revealing what this menu is all about and also a menu with each item of this menu included so that you can select more specific help. NOTE - The help system should not be used as an alternative to the manual. Before using Pro-Bat heavily you should understand a large protion of the manual. The program was not written by a professional and doesn't have a large degree of file protection written into it. If you have read the manual thoroughly you shouldn't run into any problem. I'm not saying that something WILL happen so READ THE MANUAL but there is nothing wrong with some prevention. On-Line help can be reached by phoning me at 1-(604)-365-6676 or 1-(604)-926-0366 (use the 1 only if it is long distance). I am only too glad to provide technical assistance, I realize its need and I enjoy helping you, so feel free. *FormFeed *BoldFace on 10. Running Pro-Bat *BoldFace off ProBat is a very well behaved program if you run it the way it likes to be run. By this I mean that if you keep a few things in mind about where files are and when you need and when they should be where you should avoid that noisy alarm that always sounds when something goes wrong. *BoldFace on 10.1 Running off a hard disk setup *BoldFace off With the fixed disk type set-up, I have found that using one directory say "c:\bat" to store absolutely everything you need for ProBat on that directory, and include that directory in your path command. That way when you want to run the menu program, if the last line of your CustMenu.BAT file is "CD\BAT" then the program will always return to where the files that it needs are located. The only problem though is with using the PBShow progam. Say that one of your batch files is of in some directory and it wants to run the PBShow program. What does it do? It will run the program but it won't find whatever .SCR file you want because it is located in C:\BAT. You have two options, 1) relocate the .SCR file or 2) always use a pipe command with PBShow like this: "CD\BAT | PbShow 0 MyScrns.scr | CD\WORD". With this set up DOS will go to c:\bat run PbShow and then go back to c:\word, if that's the directory the file was in - whatever! Both will work, but I recommend the latter. With this way you know where in hell all your .SCR files are, and you don't have to use long repetitive path names when refering to them inside Pro-Bat. It is however slower because the directory has to be changed. By storing all of your Pro-Bat stuff on one directory you don't have to worry about editing batch files that are on another directory like the autoexec batch file. Because you can refer to it as c:\autoexec.bat and Pro-Bat knows what you are talking about. It is for this reason that I included that function in Pro-Bat. It makes running the program a lot simpler. With this kind of a set up you won't have to use the Change dir function in the file menu but it is there if you need it. If you do decide to take advantage of the Menu you can create then you should do this type of a thing: Write an autoexec batch file that at the end changes directory to c:\bat and runs the menu program. Things should go smoothly, don't forget to add the line CD\BAT to the end of the autoexec file or PbMenu won't run properly. *BoldFace on 10.2 Running off a floppy setup *BoldFace off ProBat does really work best on a hard drive, but what program doesn't? Anyway with a little thought ProBat can be a great help even on floppy setups. If you only have one floppy though you're out of luck. All you can do is run the program and write batch files. You can take full advantage of the screen utility but all you do with the menu stuff is look at it. Or you can look at your bank account and go and by a 5 meg HD if its all you can afford. The speed of a HD alone is worth it. To run the PBMenu program you always need the system diskete in the drive that the machine booted from, always. So if you want to use the Menu program it is possible. However there is a draw back. (Isn't there always?) Because PBMenu has to read a .DTA file (PBMenu.DTA) it takes a little while running of a floppy. Soooo, what you can do is this - configure a ram disk. See your Ms-Dos manual for particulars on doing that ( if you're not running Ms-Dos 3.x forget about it ). What you can do with that is create a system diskette that has an autoexec file on it like this: echo off time date prompt $p$g copy PBMenu.* d: copy CustMenu.bat d: d: PBMenu After this, your CustMenu. bat file will look something like this when asked to run the Word process label (say it is label :3) 1 . 2 . 3 . 4 :3 5 echo off 6 cls 7 echo Please insert the Word Process diskette in drive B 8 pause 9 b: 10 WORD 11 goto DONE 12 . 13 . 14 . 15 :DONE 16 d: ( Line numbers for reference only. ) This way you have control over your applications if you want it without having to worry about DOS commands. If you are not familiar with the PAUSE command in line #8 it displays "Strike a key when ready . . ." this way you have displayed a message to the user saying that when you are finished the task you should do hit a key to continue. Remember that the disk you booted the system with should always remain in the A drive because PBMenu has to look at Command.COM everytime it runs CUSTMENU.BAT. That is where a hard drive is nice because it takes a while to read the .COM file. NOTE - If you want disk transfer of files ( reading and writing ) to work faster try adding the line "Buffers=30" to your config.sys file. *FormFeed *BoldFace on *Wide 11. The Pro-Bat Disks *BoldFace off The distribution disk holds the following files: ProBat.exe -> Pro-Bat the executable program. PBMenu.exe -> The executable menu program. PBShow.exe -> The executable program for displaying screens. PrintMan.exe -> The executable program to print the manual. ProBat.man -> The Pro-Bat manual. ReadMe.now -> Text file with last minute specific notes. RegForm.txt -> Registration form to send in. If your version doesn't contain all of these files and you would like them then write and register and I will send you a complimentary disk. If you don't have the registration form then you must include if you don't mind, your first and last names, your phone number (area code too please) and your address, along with the twenty-five dollar registration fee. Please also include the version of the copy that you are currently using and the registration number. This, so that I can justly reward whomever gave you the copy. Please see the below section Benefits of Registration for enticement to register. Make checks payable to me, Mark Tigges. In addition the diskette contains several files that are for the example on using ProBat. Study these files and understand their use and purpose and you will understand ProBat. They are: -> Example.SCR - holds the screens for the menu system -> CustMenu.BAT - batch file to carry out menu options -> PBMenu.Dta - data file holding menu data This example system should give you the ability to understand all of the facilities and power that ProBat affords the user. *BoldFace on 11.1 PrintMan.EXE . . . Usage *BoldFace off To print this manual properly you must use this file. At the Dos command line just type PrintMan. If you include "CRT" as a parameter then the manual will be printed to the screen. *FormFeed *BoldFace on *Wide 12. About Ansi.SYS *BoldFace off Ansi.SYS is a file included with MS-DOS. What it can do is this, give you control over: video attributes, cursor position, and other things. Therefore if you have used PBShow.EXE to display a screen you may want to move the cursor to a specific place on the screen. To do this you use Ansi.SYS commands in your batch file. The commands are much to lengthy to repeat here, they are in your Ms-Dos manual anyways. Besides if I listed them here I would be plagerizing from my MicroSoft press Ms - Dos manual - that is against the law so I won't. However these commands can be used just about anywhere and I use them extensively in my favorite system prompt. I have displayed that prompt for you below as an example. *BoldFace on prompt $e[s$e[7m$e[1;1H$p$e[m$e[K$e[1;67H$d$e[2;67H$t$h$h$h$e[u. *BoldFace off Quite lengthy. This is what it says. $e[s - save current cursor position $e[7m - change display attribute to reverse video $e[1;1H - move cursor to position 1,1 $p - display the path $e[m - put display attributes back to normal $e[K - delete to the end of line $e[1;67H - move cursor to position 1,67 $d - display the date $e[2;67H - move cursor to 2,67 $t - display the time $h$h$h - delete last 3 characters - hundreths of seconds $e[u - restore the cursor position, from the saved value . - the actual prompt that is there on each line By the way if you want to use the ANSI commands you have to include in your config.sys file the line "device=ansi.sys", you also have to make sure that ansi.sys is on the root directory of the system disk that you are using to boot. So now you have seen some of the basic capabilities available to you, try experimenting with them a little bit in some of your own batch files. *FormFeed *BoldFace on *Wide 13. Registering Your Copy of Pro-Bat *BoldFace off The usage liscence that I afford to users is fairly simple. Everybody who happens upon a copy of the program is granted a limited liscence. This liscence is one whose duration is 3 weeks, it is merely a trial period designed to give the user time to decide if the program is suitable for his purpose. If use is continued after this trial period then registration is reguired, which includes payment of the $35 U.S. registration fee. (Or $45 in canadian funds.) To register please follow these steps: 1. Fill out the registration form supplied on the distrubution disk in the file named RegForm.txt. The owner and registration number of the copy is displayed when ProBat starts at the version screen. Hit CTRL-V in the PullDown menu and this screen will be repeated. Hitting CTRL-R will bring up the registration information and a message about shareware, you can find the necessary information there as well. 2. Send me the completed form with enclosed check or money order at *BoldFace on Mark Tigges 2925 Altamont Cr. West Vancouver B.C. CANADA V7V 3B9 NOTE : Please make checks payable to Mark Tigges. *BoldFace off as well as an explanation for your planned use of the program, simply because I am very interested. The cost of registering your copy is $35 US, please enclose this sum with the registration form. It would be greatly appreciated if you also enclosed some hints about what I should add for future versions. If you have noticed any bugs in the program, or you think something else should happen at one point in the program, then please include that information. To make things simple for Canadian users I will accept $45 in canadian funds. If you are a business and would like to use Pro-Bat to help set up systems in your offices then you can get a lower price per unit ($5.00 discount per 5 units to minumum cost/per of $10.00 per unit). If regform.txt is not present on the distribution disk then send the following information: Your : - Name - Phone # ( inc. Area Code ) - Address ( inc. Country ) - The registration number of the copy you are using - The Version number - Amount ($) enclosed - If you want the same version you are using or the newest version - there may be a slight increase in cost for subsequent versions *BoldFace on /Benefits of registration *BoldFace off 1. Version updates for the price of a disk plus five dollars. 2. If somebody else registers a copy with your number then you get the five dollars taken away from your next version update. 3. A version of Pro-Bat that has your name written into it. Instead of somebody elses. 4. A free conscience. 5. Extensive technical assistance I can always be reached through the above address, my telephone number changes often, but my current number can be discovered through (604) 926 - 0366. Thank you very much and good luck! Thank you for registering. ShareWare is a benefit to both user and author however it can't succeed without your cooperation and support. Enjoy the program.